home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fgldrawrangeelements.z / fgldrawrangeelements
Encoding:
Text File  |  2001-04-17  |  11.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss - render primitives from array data
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss( INTEGER*4 _m_o_d_e,
  14.                                       INTEGER*4 _s_t_a_r_t,
  15.                                       INTEGER*4 _e_n_d,
  16.                                       INTEGER*4 _c_o_u_n_t,
  17.                                       INTEGER*4 _t_y_p_e,
  18.                                       CHARACTER*8 _i_n_d_i_c_e_s )
  19.  
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  22.      _m_o_d_e     Specifies what kind of primitives to render.  Symbolic constants
  23.               GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS, GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP, GGGGLLLL____LLLLIIIINNNNEEEESSSS,
  24.               GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS, GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP,
  25.               GGGGLLLL____QQQQUUUUAAAADDDDSSSS, and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN are accepted.
  26.  
  27.      _s_t_a_r_t    Specifies the minimum array index contained in _i_n_d_i_c_e_s.
  28.  
  29.      _e_n_d      Specifies the maximum array index contained in _i_n_d_i_c_e_s.
  30.  
  31.      _c_o_u_n_t    Specifies the number of elements to be rendered.
  32.  
  33.      _t_y_p_e     Specifies the type of the values in _c_o_u_n_t. Must be one of
  34.               GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT.
  35.  
  36.      _i_n_d_i_c_e_s  Specifies a pointer to the location where the indices are
  37.               stored.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is a restricted form of ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss. _m_o_d_e,
  41.      _s_t_a_r_t, _e_n_d, and _c_o_u_n_t match the corresponding arguments to
  42.      ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, with the additional constraint that all values in the
  43.      arrays _c_o_u_n_t must lie between _s_t_a_r_t and _e_n_d, inclusive.
  44.  
  45.      Implementations denote recommended maximum amounts of vertex and
  46.      index data, which may be queried by calling ffffggggllllGGGGeeeetttt with argument
  47.      GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____VVVVEEEERRRRTTTTIIIICCCCEEEESSSS and GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____IIIINNNNDDDDIIIICCCCEEEESSSS.  If end - start + 1
  48.      is greater than the value of GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____VVVVEEEERRRRTTTTIIIICCCCEEEESSSS, or if _c_o_u_n_t is
  49.      greater than the value of GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____IIIINNNNDDDDIIIICCCCEEEESSSS, then the call may
  50.      operate at reduced performance.  There is no requirement that all
  51.      vertices in the range [_s_t_a_r_t, _e_n_d] be referenced.  However, the
  52.      implementation may partially process unused vertices, reducing
  53.      performance from what could be achieved with an optimal index set.
  54.  
  55.      When ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is called, it uses _s_t_a_r_t sequential elements
  56.      from an enabled array, starting at _c_o_u_n_t to construct a sequence of
  57.      geometric primitives. _m_o_d_e specifies what kind of primitives are
  58.      constructed, and how the array elements construct these primitives. If
  59.      more than one array is enabled, each is used. If GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY is not
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      enabled, no geometric primitives are constructed.
  75.  
  76.      Vertex attributes that are modified by ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss have an
  77.      unspecified value after ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss returns. For example, if
  78.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY is enabled, the value of the current color is undefined
  79.      after ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss executes. Attributes that aren't modified
  80.      maintain their previous values.
  81.  
  82. NNNNOOOOTTTTEEEESSSS
  83.      ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is available only if the GL version is 1.2 or
  84.      greater.
  85.  
  86.      ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is included in display lists. If
  87.      ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is entered into a display list, the necessary array
  88.      data (determined by the array pointers and enables) is also entered into
  89.      the display list. Because the array pointers and enables are client-side
  90.      state, their values affect display lists when the lists are created, not
  91.      when the lists are executed.
  92.  
  93. EEEERRRRRRRROOOORRRRSSSS
  94.      It is an error for indices to lie outside the range [_s_t_a_r_t, _e_n_d], but
  95.      implementations may not check for this situation. Such indices cause
  96.      implementation-dependent behavior.
  97.  
  98.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  99.  
  100.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _c_o_u_n_t is negative.
  101.  
  102.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _e_n_d < _s_t_a_r_t.
  103.  
  104.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is executed
  105.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding ffffggggllllEEEEnnnndddd.
  106.  
  107. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  108.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____VVVVEEEERRRRTTTTIIIICCCCEEEESSSS
  109.  
  110.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____IIIINNNNDDDDIIIICCCCEEEESSSS
  111.  
  112.  
  113. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  114.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  115.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr,
  116.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss, ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr,
  117.      ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.